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Netplay 


Netplay support in RetroArch is “up in the air” as of early 2023. It is possible it's broken 
at some point for certain cores, if not all of them. 


have older versions of RetroArch, so if you and your buddies use the same old version 


1 This doesn't apply retroactively to older versions of Batocera (such as v34), which also 


you should still be able to play together. 


For a guide to set up a VPN client for multiplayer games on standalone emulators 
separate from Retroarch, visit the VPN client section. 


What is Netplay? 


Netplay is a feature enabled by RetroArch and some libretro cores to play games with multiple players 
over the network. If you want to play Double Dragon on NES with your buddy who sits several miles 
away from you... using netplay you can play both as Player 1 and Player 2 over the internet, like if you 
were both playing on the same console, sitting next to each other. 


How does this black magic work? 


Netplay relies on a client/server architecture. One of the players starts by setting up a Netplay game 
room, with a Netplay server, where the other players connect to, as clients. 


Also, all isn't “magic” here. There are several limitations to be aware of: 


You need a very stable Internet connection, with a low ping value. Like any other multi-player 
game over the internet, your user experience is heavily depending on the quality of your 
internet connection. Prefer wired ethernet networking over wifi if possible. 

All players in a Netplay session need to have the same core version, and the same ROM to play 
together. That means that you need to use the same Batocera release version, and you should 
always check and compare the MD5 checksums of the ROM that all members in your party are 
going to use. It might work when using a slightly different core version, or ROM, but your 
mileage may vary. If possible, get all the players use the same versions. 

Check that you use a core that is compatible with Netplay - see below for the list of cores that 
support Netplay. Not all cores are compatible, sometimes for the same console, only a few core 
are compatible with Netplay. 

Check that all the members of your party are using the same architecture. Some cores don't 
enable cross-architecture Netplay. Picodrive for Megadrive/Genesis will not let you play across a 
PC and Raspberry Pi, for technical endianness reasons. Whenever this happens, you'll see a 
message popping-up upon launching the RetroArch core. 


a} The word “netplay” can mean many things to many kinds of games, in this context this 


specifically refers to RetroArch's version of Netplay, which is the act of sharing the 
emulated console's screen across multiple clients. 
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How to enable Netplay 


First of all, make sure you have Batocera 5.25 or later. Netplay is not available for earlier Batocera 
releases. 


To enable Netplay for libretro cores, navigate to GAME SETTINGS > NETPLAY SETTINGS and turn 
on the toggle switch. 


ey For older versions of Batocera X Fix Me! (which?), enable netplay by adding 


global.netplay=1 in /userdata/system/batocera.conf. 


Once this is done, you can check that Netplay is enabled as when you see the help line at the bottom 
of the screen that tells you that button X in EmulationStation is now used for Netplay options (and not 
“Random selection” any more). 


How to join a Netplay game (client mode)? 


One of the players needs to host a Netplay server, to which the others players will connect to. When 
you are on the “systems” list of EmulationStation (the menu where you can select all the consoles, 
not the games), pressing the X button will give you a list of all available Netplay servers and games in 
progress. 


Some games are greyed out and marked as “unavailable”: there are some technical reasons why you 
can't join these games (different core version, game you don't own, or a different version of the 
game, and so on). 


Select one of the “available” games that you can join, and launch it: pay close attention to the 
messages that are popping up when RetroArch launches. Sometimes, there are limitations that could 
not be detected before and that will prevent you from playing (for example some cores don't support 
cross-platform Netplay, meaning that you can't have some players with a PC and others with a 
Raspberry Pi on the same game). 
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CONNECT TO NETPLAY 


s Airwolf [mame] 
& Anonymous @ us de 
@ MAME 2003Phs (184 


How to host a Netplay game (server mode) 


If you want to host your own Netplay game and let your buddies join it, you can do so by entering the 
“games” selection menu, and pressing X to launch a NetPlay server. Tell your buddies to join your 
Netplay room, when your game is launched it should appear in the menu described above. 


When you host a Netplay server, you have to make sure that your network is either compatible with 
UPNP to automatically open the right port, or you can define your own port in the settings, and 
configure your router and network to keep this port open from the outside. 


If you can't do it, or don't know how to do it, you can use the MITM option in the settings, that acts 
like a relay and simplify the Netplay server configuration. 


Configuration with Games Settings > Netplay Settings 


1. 
2. 


Enable Netplay: on/off. 
Nickname: how you will be presented in the Netplay game rooms (useful for the other players 
to find you and make sure they join the right room). 


. Port: if you need to define a specific port to enable Netplay. This is depending on your network 


configuration, and you can leave the default as empty if your router is UPNP compatible. 
Otherwise, default port is 55435. 


. Use Relay Server: in case your network can't let you open UPNP ports to host Netplay games, 


you can use this as a relay (aka MITM of “Man In the Middle”) for hosting your Netplay game. It 
does introduce a little more latency though, so use this option only if your network can't open 
UPNP ports automatically 


. Check missing indexes at startup: on/off (see below) 
. Reindex all games: let Batocera index all your ROMs in order to present only the game rooms 


with ROMs compatible with yours. This will be done in the background, with a pop-up window 
telling about its progress as it can take some time. 


. Index missing games: same, but only when you have just added new ROMs to your Batocera. 
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Current Support for Netplay 


This is the list for Batocera 5.25: 
Arcade 


e FBNeo 

e Imame 

e Mame 

e Mame2003 Plus 
e Mame2010 


Arcade Lightgun 


e Mame2003 Plus 
e Mame 2010 


Arcade Atomiswave & Naomi 
e Flycast 
Nintendo SNES 


e Pocketsnes 
e Snes9x_next 
e Snes9x 

e Mesen-s 

e Bsnes 


Nintendo NES 
e Fceumm 
e Nestopia 
e Mesen 
Nintendo GameBoy 2 Players 
e Tgbdual 
Nintendo NDS 
e Desmume 


Nintendo Famicom Disk system 


e Fceumm 
e Nestopia 


Nintendo Virtualboy 
e Beetle VB 


Sega Dreamcast 
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e Flycast 
Sega Megadrive/Genesis 


e GenesisPlusGX 
e Picodrive (does not support cross-architecture netplay) 


Sega 32X 
e Picodrive 
Sega Master System 


e GenesisPlusGX 
e Picodrive 


Sega Gamegear 
e GenesisPlusGX 

NEC PC Engine and PC Engine CD 
e Beetle PCE 

NEC SuperGrafx 
e Beetle SuperGrafx 

Neogeo and Neogeo CD 
e FBNeo 

Neogeo Pocket and Pocket Color 
e Beetle NGP 

Atari 2600 
e Stella 

Atari Lynx 


e Beetle Lynx 
e Handy 


Wonderswan and Wonderswan Color 
e Beetle Wswan 

Amstrad CPC 
e Cap32 


Amstrad GX4000 
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e Cap32 
Sinclair ZX81 

e 81 
Sega Saturn 

e Beetle Saturn 
3DO 

° 4D0 
SatellaView and Sufami 

e Snes9x 
Thomson 

e Theodore 
PC98 


e PC98 
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